package cn.iocoder.yudao.module.tms.service.companyaccountperiod;

import java.util.*;
import jakarta.validation.*;
import cn.iocoder.yudao.module.tms.controller.admin.companyaccountperiod.vo.*;
import cn.iocoder.yudao.module.tms.dal.dataobject.companyaccountperiod.CompanyAccountPeriodDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;

/**
 * 公司账期信息 Service 接口
 *
 * @author 芋道源码
 */
public interface CompanyAccountPeriodService {

    /**
     * 创建公司账期信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createCompanyAccountPeriod(@Valid CompanyAccountPeriodSaveReqVO createReqVO);

    /**
     * 更新公司账期信息
     *
     * @param updateReqVO 更新信息
     */
    void updateCompanyAccountPeriod(@Valid CompanyAccountPeriodSaveReqVO updateReqVO);

    /**
     * 删除公司账期信息
     *
     * @param id 编号
     */
    void deleteCompanyAccountPeriod(Long id);

    /**
     * 批量删除公司账期信息
     *
     * @param ids 编号
     */
    void deleteCompanyAccountPeriodListByIds(List<Long> ids);

    /**
     * 获得公司账期信息
     *
     * @param id 编号
     * @return 公司账期信息
     */
    CompanyAccountPeriodDO getCompanyAccountPeriod(Long id);

    /**
     * 根据公司ID获得账期信息
     *
     * @param companyId 公司ID
     * @return 公司账期信息
     */
    CompanyAccountPeriodDO getCompanyAccountPeriodByCompanyId(Long companyId);

    /**
     * 获得公司账期信息分页
     *
     * @param pageReqVO 分页查询
     * @return 公司账期信息分页
     */
    PageResult<CompanyAccountPeriodDO> getCompanyAccountPeriodPage(CompanyAccountPeriodPageReqVO pageReqVO);

    /**
     * 检查授信额度是否超限
     *
     * @param companyId 公司ID
     * @return 是否需要提醒
     */
    boolean checkCreditLimitAlert(Long companyId);

    /**
     * 检查账期是否临近到期
     *
     * @param companyId 公司ID
     * @return 是否需要提醒
     */
    boolean checkBillingCycleAlert(Long companyId);

}
